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• Released in 2012 

• Developed by Polytron Corporation 

• In development for over 5 years 

• Just 2 people 

• Game design/Art: Phil Fish 

• Game programmer: Renaud Bedard 
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• C# Code 

• Xbox 360 version uses XNA 

• PC Version uses MonoGame (OpenGL) 

• No C# runtime for PlayStation platforms 
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The main decision 

• Two options: 

• Port C# to PlayStation platforms 

• Straightforward (almost) game code port 
. No JIT support. Doubts on performance 

• OpenGL to native libraries 

• Rewrite C# code to C+ + 

• "Native" performance. Better optimizations 

• Lots of work. Over 500 classes 
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The main decision 

• We chose game code rewrite 

• We knew it was going to be hard 

• And long... It took almost 1 year to 
complete 

• Manual rewrite was out of question 

• Tried some automatic conversion tools 
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The main decision 

• C# to C++ Converter by Tangible 
Software 

• It made the first (rough) conversion 

• Every file had to be completed, edited 
and reviewed 

• Blind conversion. Much time passed with 
no visible progress (not even compiling) 
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The main decision 


c# 

public IEnumerableTrile> ActorTriles (ActorType type) 

{ 

return TrileSet == null ? Enumerable . Repeat<Trile> (null , 1) : TrileSet . Triles .Values .Where (x => 

x . ActorSettings . Type == type); 

} 


Auto converted 

std: : shared_ptr<IEnumerable<Trile*>> LevelManager : : ActorTriles (ActorType type) 

{ 

//C# TO C++ CONVERTER TODO TASK: Lambda expressions and anonymous methods are not converted to native 
C++: 


return get TrileSet () == nullptr ? Enumerable :: Repeat<Trile*> (nullptr, 1) : get TrileSet ()- 

>get Triles () . Values->Where (x => x . ActorSettings->Type == type); 


} 
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The main decision 


Final code 

std: : shared_ptr<List<std : : shared_ptr<Trile>>> LevelManager : :ActorTriles (ActorType type) 

{ 

if (get_TrileSet ( ) ==nullptr ) 

{ 

std: : shared_ptr<List<std: : shared_ptr<Trile>>> result = std: :make_shared<List<std: : shared_ptr<Trile»> () ; 
result->push_back (nullptr) ; 
return result; 

} 

else 

{ 

return Where (get_TrileSet () ->get_Triles (), [=] (const std: : shared_j?tr<Trile> &t) { return t->get_ActorSettings ( ) - 
>get JType ( ) == type; } ); 
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Conversion 

• Properties 

• Generate get_, set_ accessors in classes 

• Converter generated proper methods 

• .. But sometimes didn't use them 

• Needed long rewrites 

• Beware of returning temporary references, 
some compilers don't detect that! 
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Conversion 

• Be careful with operation order with -= and 
too "automated" rewrite 


c# 

PlayerManager .Velocity -= destination - instance . Center ; 

C++ wrong 

get_PlayerManager ( ) ->set_Velocity (get_PlayerManager ( ) ->get_Velocity ( ) - destination - instance- 

>get_Center ( ) ) ; 

C++ correct 

get_PlayerManager ( ) ->set_Velocity (get_PlayerManager ( ) ->get_Velocity ( ) - (destination - instance- 

>get_Center ( ) ) ) ; 
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Conversion 

• Extension methods 

• Extension methods were widely used ... 

• ... on Enums 

• No way to convert it to C+ + 

• Just create normal functions passing the 
enum as parameter 

c# 

var bitangent = orientation . GetBitangent () .AsAxis (). GetMask (); 


C++ 

auto bitangent = FezMath :: GetMask (FezMath :: AsAxis (FezMath :: GetBitangent (orientation) )) ; 
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Conversion 

• Lambda expressions & delegates 

• Game code heavily used lambda expressions 
for events, list queries ... 

• Delegates were used a lot too (threads, 
scheduled operations, scripting...) 

• They don't have direct conversion to C++ ... 

• ... but they have for C+ + 11 

• Lambdas and std: : function <> 
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Conversion 


c# 

GameState . LoadSaveFile ( ( ) => GameState . LoadLevelAsync (Util . NullAction) ) ; 

C++ 

get_GameState ( ) ->LoadSaveFile ( [=] ( ) 

{ 

get_GameState ( ) ->LoadLevelAsync ( [=] () { }); 

}) ; 

c# 

return new LongRunningAction ( (elapsed, since) => component . IsDisposed) ; 

C++ 

return LongRunningAction :: Create ( [=] (float elapsed, float since) -> bool 

{ 

return component->get IsDisposed () ; 

}) ; 
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Conversion 

• Nested lambdas caused problems with the 
converter 

• Corrupted, half-converted files 

. Unbalanced brackets generation 
. Unconverted c# code 
. Missing pieces of functions 

• Find the offending code, comment, re-convert 
the file, and manually convert that piece of 
code 
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Conversion 


c# 

DotService . Say ( "DOT_ANTI_A" , true, false) .Ended = () => 

{ DotService . Say ( "DOT_ANTI_B" , true, false) .Ended = () => 

{ DotService . Say ( "DOT_ANTI_C" , true, false) .Ended = () => 

{ DotService . Say ( "DOT_ANTI_D" , true, true). Ended = CheckCubes; };};}; 

C++ 

get_DotService ( ) ->Say ( "DOT_ANTI_A" , true, false) ->Ended = [=] () 

{ 

get_DotService ( ) ->Say ( "DOT_ANTI_B" , true, false) ->Ended = [=] () 

{ 

get_DotService ( ) ->Say ( "DOT_ANTI_C" , true, false) ->Ended = [=] () 

{ 

get_Dot Service ( ) ->Say ( "DOT_ANTI_D" , true, true)->Ended = [=] { CheckCubes () ; }; 

}; 
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Garbage Collector 

• FEZ had random stuttering due to the GC 
kicking in 

• Deterministic object destruction preferred 

• Reference counting 

• C+ + ll's std: :shared_ptr<> 

• Caused its own kind of bugs © 
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Garbage Collector 

• Circular references 

• Try to access shared_from_this() in 
constructors 

• Capturing this on lambdas caused 
problems (no reference increment) 
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Garbage Collector 

void SoundEmitter: : FadeOutAndDie (float forSeconds) 

{ 

Waiters: : Interpolate (forSeconds, [=] (float s) 

{ 

set_VolumeFactor (volumeFactor * (1 - s) ) ; 

} 

, [ = 1 0 
{ 

if (get_Cue() != nullptr && ! get_Cue ( ) ->get_IsDisposed ( ) && get_Cue ( ) ->get_State ( ) != SoundState :: Stopped) 

get_Cue ( ) ->Stop (true) ; 

}) ; 

} 

void MovingGroupsHost : :MovingGroupState : :StopSound() 

{ 

eAssociatedSound->FadeOutAndDie (0.25f) ; 
eAssociatedSound. reset () ; 
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Garbage Collector 

void SoundEmitter :: FadeOutAndDie (float forSeconds) 

{ 

auto _this=shared_from_this () ; 

Waiters :: Interpolate (forSeconds, [=] (float s) 

{ 

_this->set_VolumeFactor (volumeFactor * (1 — s) ) ; 

} 

, [=1 0 
{ 

if (_this->get_Cue ( ) != nullptr && !_this->get_Cue ( ) ->get_IsDisposed ( ) && _this->get_Cue ( ) ->get_State ( ) != SoundState: : Stopped) 
_this->get_Cue ( ) ->Stop (true) ; 

}) ; 

} 
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Reflection 

• Game scripting used reflection to: 

• Trap scripting objects events by name 

• Invoke methods by name 

• We implemented method, event, triggers... 
descriptors for scripting objects 

• Generated dynamic methods by using IL Emit 

• No dynamic code generation 
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Reflection 

script key=9 { name "Untitled" 

triggers { trigger { event "Enter" 

object { type "Volume" identifier 4 

} } } 

actions { action { 

operation "ChangeLevelToVolume" 
arguments "LIGHTHOUSE_HOUSE_A" "1" "True" 
object { 

type "Level" 

} 


"True" 


} } } 
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Reflection 


std: : shared_ptr<EntityDescriptor> IVolumeService : : GetEntityDescriptor ( ) 

{ 

//Operations 

std: : unordered_map<String, MethodDesO operations; 

operations [ "FocusCamera" ] = MethodDesc ( [=] (std: : vector<MultiTypeParameter> Sparams) -> std: : shared_ptr<LongRunningAction> 
{return FocusCamera (params [ 0] . I , params [1] . I, params [2 ] . B) ; },3 ) ; 

operations [ "SetEnabled" ] = MethodDesc ( [=] (std: : vector<MultiTypeParameter> Sparams) -> std: : shared_ptr<LongRunningAction> 

{ SetEnabled (params [0] . I, params [1] .B, params [2 ]. B) ; return nullptr;},3 ) ; 

//Properties 

std: : unordered_map<String, PropertyDesO properties; 

properties [ "Gomezlnside" ] = PropertyDesc ( [=] (int id) -> MultiTypeParameter { MultiTypeParameter mt; mt . B=get_Gomez Inside (id) ; 
return mt; } ,MultiType : : BOOL) ; 

//Events 

std: : unordered_map<String, EventHandlerDesc> events; 
events [ "Enter" ] = Eventlnstance ( SEnter, &Exit ) ; 
events [ "Exit" ] = Eventlnstance ( &Exit) ; 


return std: :make_shared<EntityDescriptor> ("Volume" , "Volume" , false, operations, properties, events) ; 

} 
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Reflection 

• Service dependencies were resolved using 
reflection 

[ ServiceDependency] 

public ISoundManager SoundManager { protected get; set; } 

[ ServiceDependency] 

public IContentManagerProvider CMProvider { protected get; set; } 

• In C++ there are no attributes, and also we can't 
get the property names 

• This was not possible to resolve the same way 
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Reflection 

• We created a base class with all the service set_ 
methods virtual, and doing nothing 

• The dependency resolver iterated all registered 
services 

• A macro called for each combination of property 
name and type, tried to dynamic_cast the service 
to the type, and if so, called the set_ method 

• All components derived from this class, so the 
overridden set_ functions actually set the value 
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Reflection 


#define MY_SERVICE SET ( propertyname, serviceclass ) \ 

if ( std : : dynamic_pointer_cast< serviced as s> ( service) ! =nullptr ) \ 

{\ 

std: : shared_ptr< serviceclass> 

private^## propertyname##_## serviced as s=std : : dynamic_point ericas t< serviced as s> ( service) ; \ 

in j ector->set_## propertyname (private_## propertyname##_## serviceclass) ; \ 

} 


MY_SERVICE SET (CameraManager, IGameCameraManager) ; 
MY_SERVICE_SET ( SoundManager , ISoundManager) 

MY_SERVICE SET (CMProvider, IContentManagerProvider ) 
MY_SERVICE_SET (TargetRenderer, ITargetRenderingManager ) 

MY SERVICE SET (TargetRenderingManager, ITargetRenderingManager) 
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.NET Framework 

• Replacement for some .NET Framework 
libraries: 

• Threads & Synchronization 

• Almost direct map to native APIs 

• lock() blocks converted to mutex. Lock() and 
Unlock() 

• Files 

• Also easy to map, and BinaryReader/Writer gave us 
the endian safe file access. 
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.NET Framework 

• String (Unicode) 

. String class derived from std: :wstring, but with C# 
like methods (SubString(),Replace(),Split()..) 

• Collections (Dictionary, List, Array) 

. Converter automatically changed them to STL 
containers (unordered_map, list, vector) 

• Nullable types 

. Implemented our own Nullable<T> class 
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.NET Framework 

• Events 

• Internally containing a std: :list<std: :function> 

• Adding a method to an event requires a lambda 

• c# CameraManager . ViewpointChanged += UpdateRotation; 

• C++ get_CameraManager ( ) ->ViewpointChanged += [=] () { UpdateRotation ();} ; 

. Initially same interface than C# (+=, -=) 

. No way to compare lambdas to remove, so we had 
to change interface and return ID 

• UpdateRotationDelegateId=get CameraManager () ->ViewpointChanged . Add ( [=] () 

{ UpdateRotation ();}); 

• get_CameraManager ( ) ->ViewpointChanged . Remove (UpdateRotationDelegateld) ; 



.NET Framework 


• LINQ was widely used to search 

• We implemented LINQ-like operations for 
STL list, vector, map: 

• Where, Any, All, Union, Exists... 

• Usage was a bit awkward sometimes 

C# if (! tracks .Any (y => y.Name == x . Track . Name) ) 

C++ if ( !Any<std: : shared_ptr<AmbienceTrack>> (tracks, [=] (const std : : shared_ptr<AmbienceTrack> 

&y) -> bool { return y->get Name ( ) == ( *x) ->Track->get Name ( ) ; })) 
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Bugfixing 

• Original game already had bugs 

• C# to C++ introduced new ones 

• Memory leaks (circular references) 

• Mixing normal and reference counted 
pointers to same object. Use after delete. 

• Returning reference to temporary object in 
get_ properties access: 

const Vector3 STrixelEmplacement : : get Position () const 

{ 

return Vector3 (X, Y, Z); 

} 



GAME DEVELOPERS CONFERENCE" EUROPE 2014 AUGUST 11-13, 2014 


GDCEUROPE.COM 


Bugfixing 

• Mistakes during manual conversion 

• Missing parenthesis on -= operations 

• Errors converting lambda expressions in 
LINQ operations 

• Uninitialized member variables 

• C++11 compiler bugs ! ! 
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Optimization 

• OK, now it worked... but slowly 

• CPU intensive code 

• Lots of geometry with inefficient 
instancing 

• Complex shaders 
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Optimization (CPU) 

• std: :shared_ptr is thread safe. We 
created a lightweight (unsafe) fast_ptr 

• Move some CPU intensive operations to 
another thread 

• Erasing std::vector elements is slow: 

• convert to std: : list 

• replace removed element with last one and 
resizeQ 
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MonoGame graphics 

• For PC, OpenGL based. 

• Two options: 

• Minimal OpenGL library for each platform 

• Custom MonoGame target for each platform 

• We anticipated GPU performance 
problems 

• Chose custom MonoGame targets 
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MonoGame graphics 

• Allows platform-specific features 

• Fine tuning for platform 

• Assets optimized per platform (swizzled, 
tiled...) 

• Shaders rewritten and optimized for each 
platform 
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Optimization (GPU) 

• FEZ doesn't look like a GPU intensive game. 

• That's wrong 

• "T rile" (tri-dimensional tile) made of 
16 x 16 x 16 "trixels" (tri-dimensional pixel) 

• Built sculpting a solid trile, removing trixels. 
Generates a lot of geometry 

• Two pass rendering 



GAME DEVELOPERS CONFERENCE" EUROPE 2014 AUGUST 11-13, 2014 


GDCEUROPE.COM 


Optimization (GPU) 
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Optimization (GPU) 
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Optimization (GPU) 

• Excessive geometry was choking vertex 
shaders 

• Only one (while moving) or two (while 
rotating) trile faces visible most of the time 

• Quick rejection of non-visible faces in CPU 
(~% of the total geometry) 

• Proper instancing 

• Huge speedup 
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Optimization (GPU) 

• Complex effects were choking the pixel 
shaders 

• Simplified code paths 

• Wrote specific "fast path" shaders to avoid 
branching 

• Moved calculations to vertex shader when 
possible 

• Most shaders unnecessarily used "discard" 
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Optimization (GPU) 
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New features 

• Cross-save (additional slot) 

• Transparent for the user if online 

• No progress merge, just latest data 

• Allows play offline, syncs when 
online 

• Stereoscopic 3D 

• Based on existing red/blue mode 

• Required extra tweaks 
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Questions? 



